home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / 第１特集Plug-in / Photoshop / PluginDigitizer.sit / PluginDigitizer / Plug-in Digitizer.rsrc / TEXT_16000_Instructions.txt < prev    next >
Text File  |  1994-10-27  |  14KB  |  225 lines
  1.                                                                               窶榔lug-in Digitizer窶™
  2.  
  3.                                                        v1.2
  4.  
  5.  
  6. The 窶榔lug-in Digitizer窶™ is a plug-in acquisition module for Adobe邃｢ 窶榔hotoshop窶™, 窶朗IH-Image窶™ or similar applications.  It allows these applications to grab images from Quicktime邃｢ compatible digitizer sources which provide a 'vdig' component.  Images can now be captured at any pixel depth and at a size different to the screen preview size.  It has a 窶惑aceless窶™ operation mode that requires no user interaction, allowing time-lapse image grabbing with suitable applications.
  7.  
  8. INSTALLATION
  9.  
  10. NIH-Image:
  11.     Place  the 窶榔lug-in Digitizer窶™ file in the 窶榔lug-ins窶™ folder which should be located in the same folder as the 窶朗IH-Image窶™ application.
  12.  
  13. Photoshop:
  14.     If there is a 窶榔lug-ins窶™ folder in the same folder as your 窶榔hotoshop窶™ application then place the 窶榔lug-in Digitizer窶™ file in the 窶榔lug-ins窶™ folder.  Otherwise place it in the same folder as your 窶榔S Prefs窶™ file which is the Photoshop preferences file.  Note, the location of plug-ins for different versions of 窶榔hotoshop窶™ appears to vary, please consult your 窶榔hotoshop窶™ documentation if the above procedures do not work.
  15.  
  16. Others:
  17.     Follow the instructions given with your application for the installation of acquisition plug-in modules.
  18.  
  19.  
  20. USE
  21.  
  22. Starting:
  23.     Launch the application.  Select the 窶榔lug-in Digitizer窶™ from the 窶連cquire窶™ sub-menu.  The plug-in's window will then appear.  The default video grabber component will be selected so that a video preview image is displayed in the plug-in's window.  If there is no Quicktime compatible digitizer component available on your computer then an error message will occur.
  24.  
  25. Window sizes:
  26.     The size of the video window can be adjusted by using the set of three radio buttons located on the left side of the plug-in's window under the title 窶老iew窶™.  These allow selection of full size, half size and quarter size preview video images.  The default is to start up at half size.  Since the plug-in will not let you preview a video image that is bigger than the screen, some size buttons may be dimmed depending on which sizes are too big for the screen.  For the extreme case where the quarter size view is bigger than the screen, an error message will occur and no video preview will be displayed.
  27.      The plug-in's window can be dragged by its title bar to any location on the screen.  It can now even be moved partially offscreen without affecting the operation of the plug-in.
  28.      Note that the size buttons are disabled whenever the video preview is frozen.  To change size restart the video preview with the 窶廊ive窶™ button to re-enable the size buttons.
  29.  
  30. Digitizer settings:
  31.     The video digitizer component settings can be set by clicking the 窶牢ettings窶™ button.  This produces the standard video settings dialog that enables you to configure particular features of your video digitizer card, or to change to a different digitizer if one is available on your machine.  The settings and the plug-in's window position are both saved and restored between calls to the plug-in, provided the calling application does not quit in between calls.
  32.  
  33. Options:
  34.     Clicking the 窶楼ptions窶™ button will bring-up a dialog box that allows various special operating features to be configured:
  35.  
  36.   窶炉aceless Operation窶™:
  37.     If the 窶炉aceless operation窶™ checkbox is checked, then when the 窶榔lug-in Digitizer窶™ is next called from the host application it will use the current settings and automatically return an image without the need for user interaction.  This facility is useful for time-lapse image grabbing.  To cancel 窶炉aceless operation窶™ hold down the 窶椀ption窶™ key on the keyboard when selecting the plug-in from the application窶冱 窶連cquire窶™ menu, and uncheck the 窶炉aceless operation窶™ checkbox in the 窶楼ptions窶™ dialog box.
  38.     Note that there is a slight delay between calling the plug-in and the return of the captured image.  The length of this delay will vary depending on the model of computer the plug-in is executing on.  The maximum achievable frame rate will therefore depend on the computer used, but it is likely to be about 1-2 secs per frame.
  39.     If an error occurs during a faceless operation an error dialog box will appear and this will require user interaction to cancel it and correct the indicated problem.
  40.     Remember to give the host application a sufficient memory allocation to store all the images to be grabbed.  
  41.  
  42.   窶賂reyscale Digitization窶™:
  43.     If the 窶賂reyscale Digitization窶™ checkbox is checked, then the 窶榔lug-in Digitizer窶™ will set the digitizer into greyscale mode to provide the maximum number of greys available for the digitized image.  Set this checkbox if you are digitizing from a monochrome source.  When it is unchecked the 窶榔lug-in Digitizer窶™ will set the digitizer to colour mode.  The state of this option is preserved between calls to the plug-in.
  44.  
  45.   窶牢pecific grab depth窶™:
  46.     This feature allows the plug-in to grab a video image at a pixel depth that is different from the current screen pixel depth as set in the 窶弄onitors窶™ Control Panel.  When the 窶牢pecific grab depth窶™ checkbox is not checked the captured image will have the same pixel depth as the screen.  When checked, the 窶賂rab depth窶™ pop-up menu is activated.  Choose the required pixel depth for the grab from the pop-up menu as required.  Note that some video digitizer may not support all pixel depths, in which case a garbled image may be returned by the plug-in.  Consult the documentation that came with the digitizer to see which pixel depth settings are valid.
  47.  
  48.   窶篭se digitizer size窶™:
  49.     This feature allows the plug-in to grab a video image at a size that is different from the screen preview size.  When the 窶篭se digitizer size窶™ checkbox is not checked the captured image will have the same size as the screen preview.  When checked, the size buttons are activated.  Choose the required digitizer size for the grab.
  50.  
  51. Capturing:
  52.     To capture a still from the video preview, first choose the options which you require: digitized image size, digitized image pixel depth, and greyscale or colour.  Then click the 窶炉reeze窶™ button.  The video preview will then freeze and display the captured image, and the 窶炉reeze窶™ button will change to a 窶廊ive窶™ button.  If you are not happy with the captured image then click the 窶廊ive窶™ button to restart the video preview, and then capture a frame again with the 窶炉reeze窶™ button.  Typing a 窶˜tab窶™ character on the keyboard has the same effect as clicking the 窶炉reeze窶™/窶廊ive窶™ buttons.
  53.  
  54. Exiting:
  55.     To exit from the 窶榔lug-in Digitizer窶™ without returning an image to the calling application, click the 窶呂ancel窶™ button or press the 窶脇sc窶™ key on the keyboard.
  56.     To exit from the 窶榔lug-in Digitizer窶™ and to send an image to the calling application click the 窶楼K窶™ button or press the 窶腕eturn窶™ key on the keyboard.  If the video preview is frozen, then the frozen frame is sent to the application.  If the video preview is live at the time of exit, it will freeze and send the image to the calling application in one operation.
  57.  
  58. About:
  59.     Clicking the 窶連bout窶ｦ窶™ button will bring-up a window displaying a copy of the instructions from this 窶漏ead Me窶™ file.
  60.  
  61.  
  62. NOTES
  63.  
  64.     In some circumstances the buttons on the left of the plug-in's window will move closer to the left-hand side of the window when particular video preview sizes are chosen.  This ensures that as much of the full screen area can be used to display the video preview so that for example, full-frame PAL video can be displayed on a 16" colour monitor.
  65.     When using 窶朗IH-Image窶™ you must choose a suitable LUT before selecting the plug-in acquisition module.  If you are grabbing a greyscale image from a greyscale source then use the 窶賂reyscale窶™ option.  Otherwise if you are grabbing a colour image from a colour source then select the colour 窶牢ystem窶™ palette.  If you try to capture a greyscale source with the colour 窶牢ystem窶™ palette then the grey levels will be converted to the available greys in the palette giving less than 16 shades of grey.
  66.     When using 窶榔hotoshop窶™ to grab greyscale images you must set your monitor to 窶賂reys窶™ by using the 窶弄onitors窶™ Control Panel.  When grabbing colour images leave the monitor set to 窶呂olours窶™.
  67.     When using 窶朗IH-Image窶™ a simple macro can be used to start the 窶榔lug-in Digitizer窶™ with a simple key-press.  For example:
  68.  
  69.  macro 'Acquire Video [A]';
  70.    begin
  71.       Acquire('Plug-in Digitizer');
  72.    end;
  73.  
  74. To produce a time-lapse sequence first select the 窶榔lug-in Digitizer窶™ from the 窶連cquire窶™ menu and configure its settings to those required for the images to be grabbed.  Check the 窶炉aceless operation窶™ checkbox in the 窶楼ptions窶™ dialog box.  Use this simple macro example to grab 10 images with an interval of  5 seconds (plus the delay for the capture of an image) between each:
  75.  
  76.  macro 'Acquire Time-lapse Video [B]';
  77.    var
  78.        number,count : integer;
  79.        delaySecs : real;
  80.    begin
  81.       number := 10;
  82.       delaySecs := 5;
  83.       for count := 1 to number do
  84.          begin
  85.             Acquire('Plug-in Digitizer');
  86.             wait(delaySecs);
  87.          end;
  88.    end;
  89.  
  90. A more complex macro that saves the sequence of images to disk is given below.  Note that this example requires version 1.55 of NIH-Image, and the example is courtesy of NIH-Image窶冱 author Wayne Rasband.
  91.  
  92. macro 'Make AV Movie to Disk';
  93. {
  94. Captures images using 'Plug-in Digitizer' and saves
  95. them to disk.  Abort at any time by pressing the mouse button.
  96. }
  97. var
  98.     nFrames,n:integer;
  99.     interval,StartTicks,EndTicks:integer;
  100.     time:real;
  101.     path:string;
  102. begin
  103.     Requiresversion(1.55);
  104.     path := GetString('Folder path:','MyHD:movie');
  105.     nFrames := GetNumber('Number of Frames?',10);
  106.     time := GetNumber('Delay Between Frames (seconds)?',60.0);
  107.     interval := round(time*60);
  108.     StartTicks := TickCount;
  109.     EndTicks := TickCount+interval;
  110.     for n := 1 to nFrames do
  111.     begin
  112.         time := (TickCount-StartTicks)/60;
  113.         ShowMessage(n:3,'   ',time:4:2);
  114.         Acquire('Plug-in Digitizer');
  115.         MoveTo(2,12);
  116.         SetFontSize(12);
  117.         SetForegroundColor(255);
  118.         write(n:3,'   ',time:4:2);
  119.         SaveAs(path,':Frame ',n);
  120.         Dispose;
  121.         while TickCount < EndTicks do
  122.         begin
  123.             if button then exit;
  124.         end;
  125.         EndTicks := EndTicks+interval;
  126.     end;
  127. end;
  128.  
  129. See the 窶朗IH-Image窶™ manual for more details of programming macros.
  130.  
  131.  
  132. RELEASE NOTES
  133.  
  134. ______________________
  135. v1.0 - 28/01/94
  136.  
  137. - First full release
  138.  
  139. ______________________
  140. v1.0.1 - 08/02/94
  141.  
  142. - First bug fix release
  143.  
  144. - Fixed bug in which compression settings were not saved and restored between calls to the plug-in.
  145.  
  146. - Fixed bug where garbled image was returned in 24-bit addressing mode.
  147.  
  148. - Fixed bug so that it works with Quicktime 1.5 as well as 1.6.
  149.  
  150. - Full VideoSpigot PAL can now be displayed on 16" monitors.
  151.  
  152. - Can capture 16/32-bit per pixel colour images.
  153.  
  154. - Checks for availability of Quicktime.
  155.  
  156. - Now displays the version number in the logo.
  157.  
  158. - Changed name to US spelling "digitizer" instead of UK spelling "digitiser"!
  159.  
  160. ______________________
  161. v1.0.2 - 15/03/94
  162.  
  163. - Second bug fix release
  164.  
  165. - When resized the centre of the window remains fixed - previously the top-left corner was fixed.  The top-left corner will be adjusted to always keep it on-screen when resizing.
  166.  
  167. ______________________
  168. v1.1 - 23/03/94
  169.  
  170. - First minor upgrade
  171.  
  172. - Added faceless operation mode to allow time-lapse image grabbing (by popular demand).
  173.  
  174. ______________________
  175. v1.2 - 26/10/94
  176.  
  177. - Second minor upgrade
  178.  
  179. - Added support for offscreen grabs so that images can be grabbed at a pixel depth and size other than that of the screen preview.
  180.  
  181. - Eliminated the need for the preview image to be completely on screen when grabbed.
  182.  
  183. - Allows greyscale option to be set.
  184.  
  185. ______________________
  186.  
  187. KNOWN PROBLEMS:
  188.  
  189. - Settings dialog sometimes does not display live video.
  190.  
  191. - Does not return correct image when used with VideoSpigot 窶˜vdig窶™ at full size.
  192.  
  193. - Has not been tested with all the available vdig窶冱.  Extensive testing on AV Macs has taken place, together with limited testing on the VideoSpigot 窶˜vdig窶™.  If you have problems with the operation of plug-in and a particular 窶˜vdig窶™ please ensure first that you are using the latest version of the 窶˜vdig窶™.
  194.  
  195. ______________________
  196.  
  197. FUTURE ENHANCEMENTS:
  198.  
  199. - Please send your own suggestions for future enhancements to the author.
  200.  
  201. ______________________
  202.  
  203. ACKNOWLEDGEMENTS
  204.  
  205. Thanks to Nick Safford, Colin Ager and Wayne Rasband (author of 窶朗IH-Image窶™) for beta-testing and suggestions.
  206.  
  207. ______________________
  208.  
  209. LICENSE
  210.  
  211. This software is ﾂｩ Cyrus Daboo.  This software is Freeware for personal and academic use.  It may be freely distributed provided this 窶漏ead Me窶™ file accompanies the plug-in.  Commercial users may try out this software for 30 days after which a Shareware fee of $15 per copy will be payable for continued use.  Users wishing to include it with their own commercial products must negotiate a fee with the author.  Please send Shareware fees to the address below - an invoice will be provided on request.
  212.  
  213. ______________________
  214.  
  215. BUGS
  216.  
  217. Please report all bugs to Cyrus Daboo:
  218.  
  219. mail:       Cyrus Daboo,
  220.                64 Mulberry Close,
  221.                Cambridge  CB4 2AS.
  222.                UK.
  223.  
  224. phone:     +44 1223 328240
  225. e-mail:    cd102@phy.cam.ac.uk